home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / internet / wincod27.zip / README.NOW < prev    next >
Text File  |  1996-05-08  |  20KB  |  446 lines

  1. ********************************************************************************
  2. ***       READ THIS ENTIRE FILE BEFORE USING WINCODE v2.7.2 BETA             ***
  3. ***                                                                          ***
  4. *** THE V2.3 HELP FILE IS THE MOST RECENT (FREE) REFERENCE FOR USING WINCODE ***
  5. ***     THE V2.6 W95B HELP FILE IS THE MOST RECENT REGISTERED VERSION        ***
  6. ***                                                                          ***
  7. ***   THE V2.7 SPECIFIC HELP FILE WILL BE AVAILABLE WHEN THE NEXT OFFICIAL   ***
  8. ***   NON-BETA VERSION OF WINCODE IS RELEASED (2.7.3) LATER THIS YEAR.       ***
  9. ***   WE WILL TRY TO PROVIDE ONGOING "INTERIM" RELEASES SO KEEP AN EYE ON    ***
  10. ***   OUR WEB SITE FOR DETAILS...                                            ***
  11. ***                                                                          ***
  12. ********************************************************************************
  13.  
  14. PLEASE SEE THE FOLLOWING FILES FOR MORE INFORMATION:
  15.  
  16. README.TXT
  17. HELPME.HLP
  18. VSDLINK.DAT
  19. LICENSE.TXT
  20.  
  21.  
  22. WHAT YOU SHOULD KNOW:
  23. ---------------------
  24. This is Wincode v2.7.2 *BETA*. It will EXPIRE on September 10, 1996. Why?
  25. Because we do not want "unpolished" versions of Wincode floating on the net
  26. coming back to haunt us! :-) Don't worry - Wincode is still FREEWARE and it
  27. is NOT riddled with BUGS :-). This BETA release will allow you to enjoy the
  28. new features now while we concentrate on polishing the product...and hey,
  29. if you DO find a bug, let us know - we'll give you a free HELP file
  30. registration...
  31.  
  32. Several new/improved features have been added to this release. Most notably,
  33. this version has been extensively tested and optimized under Win95 (however,
  34. no support for LFN, yet!). Also, we have added YACA (Yet Another Coding
  35. Algorithm) and scripting support (see below). In the future, we will provide
  36. native Win95/NT 32-bit versions. Keep an eye out for updated info. This can be
  37. easily obtained by sending a BLANK e-mail to:
  38.  
  39.    wincode@snappy.global2000.net
  40.  
  41. You will receive an auto-reply of the latest info on Wincode.
  42.  
  43.  
  44. CTL3DV2
  45. -------
  46. The file CTL3DV2.DLL is used by Wincode to give it the "3D" look. This file,
  47. however, is included with many other products and may already be installed
  48. on your system. By default, the Installer will NOT copy this file to your
  49. system. It may be in use by Windows and would yeild an (harmless) error. For
  50. your benefit (read = Just In Case), we have included a RENAMED copy of the
  51. file with the Wincode archive. If any Wincode dialog appears "old-style"
  52. (i.e. white face and boxed edges), you can install the CTL3DV2.DLL. The
  53. procedure is quite simple:
  54.   1) The file MUST be located in the Windows SYSTEM directory.
  55.   2) If you do not see the file there, copy the included file CTL3DV2.JIC to
  56.      your Windows SYSTEM directory and rename it CTL3DV2.DLL.
  57.   3) If you DO see a file there, check the version number and make sure it is
  58.      at LEAST version: 2.26.000. If not, rename it (for backup) and do
  59.      step 2 above.
  60.   4) Thats it!
  61.  
  62.  
  63. ARCHIVING:
  64. ----------
  65. In preparation for the coming releases, we have created a new file archive
  66. naming system as follows:
  67.  
  68.    WCxxxyzz.ZIP
  69.  
  70. where
  71.    WC   =  Wincode  
  72.    xxx  =  the Wincode version number
  73.    y    =  R for official release or B for beta
  74.    zz   =  either 16 for 16-bit version (Win3.1x) or
  75.            32 for 32-bit version (Win95/NT)
  76.  
  77. For example, WC271B16.ZIP would be Wincode v2.7.1 for Win3.1x BETA release.
  78.  
  79.  
  80. AVAILABILITY:
  81. -------------
  82. With the formation of the _Snappy_ Software internet site, users now have a
  83. place where they are guaranteed to be able to get the latest news and updates
  84. for _Snappy_ software. Please note that our "official" server is ONLY online
  85. between midnight and noon Eastern Standard time 7 days a week. It is NOT a 24
  86. hour server though we CAN receive e-mail round the clock. You may get a WARNING
  87. message but please know that your e-mail *will* be delivered. Note that the
  88. times listed here are maintained given that our internet provider is up and
  89. running and our server is not in use for development...
  90.  
  91. Please send any feedback to:
  92.  
  93.    feedback@snappy.global2000.net
  94.  
  95. Please send any bug reports to:
  96.  
  97.    bugs@snappy.global2000.net
  98.  
  99. Check out our HomePage for further details at:
  100.  
  101.    http://snappy.global2000.net/
  102.  
  103. PLEASE NOTE: There is now a _Snappy_ HomePage MIRROR site that is online
  104. full-time (24 hours/7 days). We encourage you to please use that site whenever
  105. possible - it will always have the latest release of Wincode and it is *MUCH*
  106. faster for downloads. It can be found at:
  107.  
  108.    http://www.global2000.net/users/snappy/snappy/
  109.  
  110.  
  111. NEW FEATURES/OPTIONS:
  112. ---------------------
  113. New to version 2.7.2 BETA:
  114.  
  115.  - Yet another coding algorithm has been added: BTOA. As part of our goal to
  116.    support all Binary/ASCII conversion methods in one (quality :-) product,
  117.    Wincode now supports encoding/decoding of BTOA v4.0 and v5.2. This
  118.    algorithm supports simple compression, several checksum options and will
  119.    generally create encoded files that are smaller than other methods due
  120.    to its conversion algorithm (mod 85).
  121.  
  122.  - We have changed the "File Open" dialogs to be more intuitive. There is now
  123.    a Code Type combo-box that will let you change the en/de-code type on-the-
  124.    fly. This feature *WAS* in previous versions of Wincode, however, it
  125.    required that you double-click the dialog title bar (it would cycle through
  126.    the code types). People wrote in that it was not very intuitive...so we
  127.    listened :-) You will notice that the "All Files" button is gone :-(
  128.    However, the "All Files" functionality (which is to "select" all files that
  129.    are of a given "type" - i.e. "*.txt") is *STILL* available. Just HOLD DOWN
  130.    THE CTRL KEY and select "OK" - Wincode will process "all files" of the
  131.    listed type.
  132.  
  133.  - The AUTO DETECT decoding option will now try to detect the code type by
  134.    scanning the ENTIRE file. It will adjust the code type to the FIRST type
  135.    that it encounters. If there is more than one encoding type in a file
  136.    (*highly unlikely*), you will have to decode the non-detected portions
  137.    manually (better yet, try Winsort first which may help). Wincode tries to
  138.    recognize UUE, XXE, User Defined, BASE64 (MIME), BINHEX and BTOA. It can NOT
  139.    Auto-Detect "raw" BASE64 or BOO. These two coding types should NEVER exist
  140.    in a file which contains extraneous data - this makes it "nearly" impossible
  141.    to detect the algorithm! The detection scheme works by identifying certain
  142.    unique aspects of each coding algorithm. It is NOT fool-proof ;-) :-)
  143.  
  144.  - Several bug fixes were implemented. Most notably we have again improved
  145.    Wincodes ability to handle MIME files (now recognizes some "non-standard"
  146.    headers - again, we don't agree with the programs that create non-standard
  147.    MIME files, but we do it for completeness sake ;-)
  148.  
  149.  - MAJOR overhaul of the Wincode EPD. The E-mail/Post option has now become
  150.    both easier to use and intuitive. Wincode now has an "Address Book" which
  151.    can store addresses/descriptions etc. The Wincode EPD has been patched to
  152.    work with a few "problematic" SMTP servers we encountered plus it now can
  153.    handle CC:, BCC: and will deliver mail in a "bulk" fashion thus lessening
  154.    the load on your e-mail/newsgroup server.
  155.  
  156.  - Scripting has been modified (as noted below) to work with the new Wincode
  157.    EPD. Notably, four commands are no longer valid (compared to version 2.7.1
  158.    BETA). This should not present much of a problem. We welcome any comments
  159.    to our changes...
  160.  
  161. The following notes have been kept for completeness sake...
  162. (RE: 2.7.1 BETA/2.7.0 release)
  163.  
  164. New to version 2.7.1 BETA:
  165.  
  166.  - Yet another coding algorithm has been added: BOO. This simple coding
  167.    algorithm was (is) used in cross-platform file transfer where software
  168.    could automatically encode/decode the data. It requires PREVIOUS knowledge
  169.    of the decoded files output size. Otherwise, inherent flaws in the coding
  170.    algorithm (NOT bugs in Wincode) CAN produce decoded output that is 1 to
  171.    3 bytes LARGER than the original encoded file. Most files can tolerate
  172.    the appended NULL bytes, but it is not recommended.
  173.  
  174.  - Improved "Concatenation" option. Actually, this option has been extended
  175.    to allow for file "splitting" as well. The splitting feature can be used
  176.    to overcome the BOO limitations stated above.
  177.  
  178.  - Several fixes and code optimizations. Especially with regard to Win95.
  179.  
  180. NOTE: The following scripting section reflects the v2.7.2 BETA standard. It
  181. does not represent the original text included with Wincode v2.7.1 BETA.
  182.  
  183.  - New simple YET powerful scripting ability. Wincode can now function using
  184.    a scripted language. This feature allows for repairing of damaged files
  185.    (see below) but also allows you to "program" Wincode. The scripts take the
  186.    following form (a more EXTENSIVE explanation will accompany the OFFICIAL
  187.    (non-BETA) release of Wincode - sorry!):
  188.  
  189.    - All scripts begin and end with a keyword WINCODESCRIPT located in the
  190.      FIRST column of a text file (it can be ANYWHERE in the file as long as
  191.      the keyword starts in column one).
  192.    - The following commands are recognized (items in brackets MUST be
  193.      provided). Anything that is not a "command" is treated as a comment:
  194.  
  195.      CLOSE
  196.      
  197.         - close the Wincode application.
  198.  
  199.      CONFIG [filename]
  200.  
  201.         - [filename] is a preconfigured WINCODE.INI file that Wincode will
  202.           dynamically load into memory and use.
  203.  
  204.      DECODE [filename]
  205.  
  206.         - [filename] will be decoded immediately using the active
  207.           configuration (if not part of "GROUP" - see below).
  208.  
  209.      ENCODE [filename]
  210.  
  211.         - [filename] will be encoded immediately using the active
  212.           configuration (if not part of "GROUP" - see below).
  213.  
  214.      EPD [ON/OFF]
  215.  
  216.         - toggles the Wincode E-Mail/Post Daemon option. The "E-Mail/Post TO:"
  217.           dialog will appear (when files are encoded) to allow you to select
  218.           a receiver/newsgroup.
  219.  
  220.      GROUP
  221.  
  222.         - used to mark a subset of files that will be treated as a "group"
  223.           (i.e. a "batch job"). This is used for specifying a series of files
  224.           that will be ZIPped into one file then encoded. Valid values are
  225.           either "ENCODE" or "DECODE" followed by the file specification. The
  226.           "group" ends with the keyword "GROUP" at which point Wincode will
  227.           process the batch job.
  228.  
  229.      MINIMIZE
  230.  
  231.         - this minimizes the Wincode application window.
  232.  
  233.      REPAIR [CREATE/FIX]
  234.  
  235.         - this is a special script language keyword RESERVED by Wincode to
  236.           create "Repair" scripts. Wincode can use these scripts to repair
  237.           "damaged" decoded files. A scenario is given below...
  238.  
  239.      RESTORE
  240.  
  241.         - this maximizes (opens) the Wincode application window.
  242.  
  243.      UNHOOK
  244.  
  245.         - this unhooks the Wincode application.
  246.  
  247.      UNZIP [ON/OFF]
  248.  
  249.         - toggles the Wincode UNZIP After option.
  250.  
  251.      ZIP [ON/OFF]
  252.  
  253.         - toggles the Wincode ZIP First option.
  254.  
  255.    - Example:
  256.  
  257. ; here's a sample script
  258. WINCODESCRIPT
  259.  
  260. ; first lets minimize wincode to get it out of the way :-)...
  261.   MINIMIZE
  262.  
  263. ; lets grab a few files, zip them up and encode them
  264. ; toggle zip option
  265.   ZIP ON
  266.  
  267. ; start a group of files
  268.   GROUP
  269.  
  270. ; grab some files (this doesn't encode them till the next "GROUP" keyword)
  271.     ENCODE c:\autoexec.bat
  272.     ENCODE c:\config.sys
  273.  
  274. ; end the group of files
  275.   GROUP
  276. ; at this point, Wincode processes the files as a batch job...
  277.  
  278. ; thats done...
  279.  
  280. ; now lets post a DOOM wad file...
  281. ; ZIP is still ON from above!
  282. ; enable the e-mail/post daemon
  283.   EPD ON
  284.  
  285. ; encode and send it!
  286.   ENCODE c:\doom\mydoom.wad
  287.  
  288. ; At this point, Wincode prompts for a destination. Enter the proper
  289. ; newsgroup and away we go :-)
  290.  
  291. ; thats done
  292. ;
  293. ; etc, etc - you get the picture right?
  294. ;
  295.  
  296. ; lets see wincode again :-)...
  297.   RESTORE
  298.  
  299. ; done!
  300. WINCODESCRIPT
  301.  
  302.    - NOTE on scripts: all changes to the Wincode options (i.e. enabling
  303.      posting, zip options, etc) exists ONLY during the execution of the
  304.      script. When Wincode is finished, it reloads a copy of the orginal
  305.      configuration BEFORE the script was executed...
  306.  
  307.  - As mentioned above, there are now new scripting commands which allow
  308.    Wincode to REPAIR damaged files. How? Well, it is best explained in
  309.    the following scenario. Note that this requires interplay with the person
  310.    that originated the encoded file. The lines in the scenario below
  311.    represent the ORDER of events, where * = receiver and + = sender:
  312.  
  313.     * I receive a 3MB (!) encoded file from a friend and try to decode it.
  314.     * Wincode is chugging along when it realizes that the last 100K is
  315.       missing or damaged. Agh! I just spent 30 minutes downloading this
  316.       e-mail from "your-favorite-inet-provider-here" which cost me $XX.XX!
  317.     * Luckily, I had both "Error Checking" and "Create Report Files" enabled.
  318.       I see in the report file that Wincode has created a Repair Script(!)
  319.       located in the same directory as the recent damaged output file. This
  320.       is called the "CREATE" repair script.
  321.     * Now what? Well, I take this tiny (100-200 byte!) file and mail it to
  322.       the friend that sent me the original 3MB file. I SAVE THE DAMAGED
  323.       DECODED FILE (YOU DO NOT NEED THE ENCODED ONE :-).
  324.     + (S)he takes the Wincode Script and feeds it to Wincode. This is done
  325.       by selecting File|Script... or Drag & Drop and checking the "Script"
  326.       option.
  327.     + Wincode prompts for the original "template" data file (i.e. the file
  328.       which was originally encoded and mailed to me). My friend enters the
  329.       FULL path using the convenient dialogs :-)
  330.     + Wincode analyzes the file, comparing it to data it has stored in the
  331.       repair script. If all is OK, it does two things:
  332.         1) creates a new Repair script called the "FIX" script
  333.         2) extracts and encodes the portion of the orginal file that was
  334.            damaged in the receivers (my!) copy. In this scenario, it is
  335.            around ~130K worth of data.
  336.     + My friend takes these two files and e-mails them back to me.
  337.     * After a 1 1/2 minute download of the files (vs 30 min. for original
  338.       file), I am ready to repair the data.
  339.     * I save the two separate files in the same directory as the original
  340.       damaged decoded file (for neatness :-)
  341.     * I open Wincode and feed it the NEW script file.
  342.     * Wincode first prompts me for the location of the DAMAGED file I wish
  343.       to fix (which I SAVED above). I give it a full path and it once again
  344.       verifies the data.
  345.     * Now Wincode prompts for the location of the "repair data". This is the
  346.       small 130K data file my friend sent back.
  347.     * Wincode then starts patching the original file. When done, it re-scans
  348.       the ENTIRE output file and verifies the data. If all went well, I have
  349.       now fixed the damaged file and saved a few online buck$ :-)
  350.  
  351.    Simple, no? The events, in "flow-chart" form, are:
  352.  
  353.      -----------                -------------------       -----------------
  354. --> |decode data| --> bad? --> |script file created| --> |mail to orginator|
  355.      -----------                -------------------       -----------------
  356.           |                                                       |
  357.           |                    --------------------------------------------
  358.         good?                 |use script to create new FIX script and data|
  359.           |                    --------------------------------------------
  360.           |                                    |
  361.           |                    ------------------------------------
  362.           |                   |mail fix and repair data to receiver|
  363.           |                    ------------------------------------
  364.           |                                    |
  365.           |                    ------------------------------------------
  366.           |                   |use script and data to repair damaged file|
  367.           |                    ------------------------------------------
  368.      -------------                             |
  369.     |happiness :-)|<-------------------------- /
  370.      -------------
  371.  
  372.  
  373. New to version 2.7.0 RELEASE:
  374.  
  375.  - YES, it now supports BINHEX ENCODING and DECODING! We have even included
  376.    an encode option that will allow you to add the correct MAC Finder info
  377.    (See the HELPME.HLP file 'A Simple Encode Example' Note for details). The
  378.    BINHEX algorithm supports RLE (Run Length Encoding) which can dramatically
  379.    reduce the size of the resulting encoded file (ZIPped files do not benefit
  380.    much, however).
  381.  
  382.  - The AUTO DETECT decoding option will now try to detect the code type of the
  383.    file. It tries to recognize BINHEX and BASE64 but will default to UU/XX/
  384.    User Defined code type. The detection algorithm is VERY simple and only
  385.    scans the first 16K of each input file.
  386.  
  387.  - If you have a Winsock setup, Wincode can now automatically handle e-mailing
  388.    and Posting of encoded documents. Just drag and drop :-) If you do NOT have
  389.    a Winsock or are not planning to use Wincodes e-mail/post features, then
  390.    you can delete the files WCESOCK.EXE to conserve disk space :-)
  391.  
  392.  - Now includes integrated Virus Scanning using a DOS based virus scanner.
  393.  
  394.  - Winsort now can filter out HTML conversion codes. This allows one to decode
  395.    files that were saved using a WWW browser. To see this effect, try using
  396.    one of the many Net Search engines to locate an encoded article from an
  397.    Internet Newsgroup. When you save this article (or retrieve it from the
  398.    cache), it will contain special HTML escape codes which corrupt the encoded
  399.    data. Winsort can now rescue these files.
  400.  
  401.  - The Hooking feature has been updated to fix two major incompatibilities.
  402.    First, it is now more "aware" of the types of Windows it can and cannot
  403.    hook. This resolves the issue with the Dropper application. Second, and
  404.    most importantly, the "grayed menu" bug has been fixed. There is a NEW
  405.    option, 'Double Hook Menu', in the Hook Tuning section. Enabled the double
  406.    hook and Wincode will dynamically monitor the applications menu and make
  407.    adjustments as needed. This works great for MDI applications (e.g. Free
  408.    Agent) which change the main menu when different windows are selected. If
  409.    the Wincode menu disappears, just click the menu and it will reappear!
  410.  
  411.  - The HELPME.TXT text file has been converted to a Windows HELP file. This
  412.    FREE Help will now start any time an unregistered user selets a Help
  413.    option within Wincode.
  414.  
  415.  - revamped interface to the latter Windows 3.11 "look" - yes, Win95 is 
  416.    here but we have updated Wincode to use the 3-D look. You will need
  417.    CTL3DV2.DLL to take advantage of this feature. This DLL is a part of
  418.    many newer Microsoft application distributions.
  419.  
  420.  - new Configuration dialog - tabbed notebook. Makes life much easier :-)
  421.  
  422.  - Use of Common Dialogs for file encode/decode. In fact, if you select 
  423.    'File|Encode' or 'File|Decode' you can also now change the CODE TYPE by 
  424.    double clicking the dialog TitleBar...
  425.  
  426.  - Improved speed. Code was ported to Borland Delphi (which explains the 
  427.    larger file size - sorry!) and there will be a TRUE Win95 32-bit version 
  428.    available soon after Borland releases Delphi32 (Delphi 2.0 is scheduled for
  429.    release on March 1, 1996).
  430.  
  431.  - Fixed Code bugs and the "disappearing Wincode" bug...
  432.  
  433.  - Improved the interactive Drag and Drop code to allow selection of different
  434.    Code Types for encoding vs decoding.
  435.  
  436.  - Added links to the Auto E-mail/Post engine.
  437.  
  438.  - Expanded the ButtonBar and menus to include a few other essential features.
  439.  
  440.  - Many internal updates and code enhancements that will come as a nice
  441.    surprise to hardcore Wincode users... :-)
  442.  
  443. --------------------------------------------------------------------------
  444.  
  445. [GHS 05/08/96]
  446.